home *** CD-ROM | disk | FTP | other *** search
/ Ian & Stuart's Australian Mac: Not for Sale / Another.not.for.sale (Australia).iso / fade into you / being there / Issues & Ideas / TIA / doc / tia.single.instruct < prev    next >
Text File  |  1994-08-23  |  19KB  |  455 lines
  1.       INSTALLATION INSTRUCTIONS FOR THE SINGLE USER VERSION
  2.                   OF THE INTERNET ADAPTER (tm)
  3.                      Revision 1.0.1 (8/23/94)
  4.  
  5. PLEASE NOTE: Post-release changes are being made daily to this 
  6. document as we receive feedback from the hundreds of new users of TIA. 
  7. If you have problem installing TIA, check for a newer version of this 
  8. document available by e-mail at:
  9.  
  10.      tia-install-single@marketplace.com.
  11.  
  12. You should also request the TIA Single User FAQ at:
  13.  
  14.      tia-FAQ-single@marketplace.com. 
  15.  
  16. Both documents are also available by gopher or World Wide Web at:
  17.  
  18.      marketplace.com
  19.  
  20. It is strongly suggested you read this document *in its entirety* 
  21. before you begin installing TIA (so many problems are avoided that 
  22. way...)
  23.  
  24. OVERVIEW
  25.  
  26. The Internet Adapter (TIA) is a commercial Internet access utility 
  27. that runs on the UNIX computer that hosts your Internet login or 
  28. "shell" account. TIA  does _not_ run on your Macintosh or PC. Your 
  29. Macintosh, PC, or other "client" computer must be setup with the 
  30. software required to use a standard SLIP Internet account (see partial 
  31. instructions at the end of this document).
  32.  
  33. Since TIA is a binary executable program (i.e. not a script) you must 
  34. run the version that corresponds to the hardware and operating system 
  35. of your UNIX host computer. TIA is currently available for:
  36.  
  37. Hardware    Operating System  Available
  38. ---------------------------------------
  39. Sun Sparc   Solaris 2.x       now
  40. Sun Sparc   SunOS 4.1.x       now
  41. 386/486     BSDI 1.x          now
  42. 386/486     SCO               8/31/94
  43.  
  44. Other "ports" of TIA are in progress and will be available shortly. 
  45.  
  46.  
  47. STEP 1. CONFIRM THAT THE TIA LICENSE CODE FILE IS PROPERLY INSTALLED
  48.  
  49. Make sure you have the TIA License Code file properly installed in 
  50. your home directory. These instructions assume you have already 
  51. ordered and received your TIA Evaluation or Registered License Code 
  52. via email. The TIA License Code message containing the actual TIA 
  53. License Code (e.g., TIACODE:6589384766aF30) should have been saved in 
  54. a file called '.tia'.
  55.  
  56. The .tia file needs to be in the CURRENT directory when you run TIA. 
  57. We recommend you keep the TIA program and the ".tia" file in your home 
  58. directory, i.e. the directory you are automatically taken to when you 
  59. login to your account, and that you start TIA from that directory. To 
  60. confirm the .tia file is there type the following command in your home 
  61. directory:
  62.  
  63. ls -a
  64.  
  65. To view the contents of the .tia file type the following command:
  66.  
  67. more .tia (or cat .tia)
  68.  
  69. We recommend that you make 2 backup copies of your .tia file. Store 
  70. one in another file (e.g., .tia.backup) and one as a text file on your 
  71. Macintosh or PC.
  72.  
  73.  
  74. STEP 2. DETERMINE WHICH BINARY VERSION OF TIA YOU NEED TO RUN
  75.  
  76. All the TIA binary versions are available via anonymous FTP from 
  77. MarketPlace.com. You need to determine which binary is the correct one 
  78. for your account. If you don't know that already, download the Free 
  79. Software Foundation's (the GNU folks) "config.guess" script from 
  80. Marketplace.com via anonymous FTP and run that on your machine. It 
  81. should tell you what you need to know. If you are not familiar with 
  82. FTP here is what you need to type (each line is a separate step -- 
  83. lines in brackets [] must be replaced with your input, and all 
  84. parentheticals are remarks): 
  85.  
  86. ftp marketplace.com
  87. [type 'anonymous' when prompted for your login name]
  88. [type your complete email address when prompted for your password]
  89. cd tia
  90. ascii (makes sure your ftp is transferring in ASCII mode)
  91. get config.guess
  92. bye
  93. chmod u+x config.guess
  94. ./config.guess
  95.  
  96. The screen readout will tell you the type of machine and operating 
  97. system you are on.
  98.  
  99. ***NOTE: You may also see if the 'uname' command is supported on your 
  100. host and gives you the information you need. Type: 'uname -a' and see 
  101. what info it provides you. It may or may not tell you enough info.
  102.  
  103. You may also check on Marketplace.com where we will be creating a 
  104. table of popular sites and binary types.
  105.  
  106. If you cannot find this information you may also use the "brute force" 
  107. approach: download all the different binary versions of TIA from 
  108. MarketPlace.com and try them until you find one that runs correctly on 
  109. your host computer! (Each binary is approximately 200K.)
  110.  
  111.  
  112. STEP 3. DOWNLOAD THE CORRECT VERSION OF TIA FROM MARKETPLACE.COM
  113.  
  114. Once you know the correct binary you need, connect to marketplace.com 
  115. via FTP and cd to the 'tia' directory. Each version of tia has a 
  116. descriptive name such as:
  117.  
  118.      sparc.sunos.tia, sparc.solaris.tia, 386.bsdi1.1.tia, etc.
  119.  
  120. If there is a binary version of TIA for your host, download that 
  121. version using File Transfer Protocol (FTP) from MarketPlace.com. 
  122. Example steps:
  123.  
  124.  
  125. ftp marketplace.com
  126. [type 'anonymous' when prompted for your login name]
  127. [type your complete email address when prompted for your password]
  128. cd tia
  129. binary (makes sure your ftp program is in BINARY transfer mode)
  130. get <tia.pgm.name> (where <tia.pgm.name> is the file name
  131.      corresponding to the binary for your host computer)
  132.  
  133. (You may also want to check the READ.ME files in this directory for 
  134. any late breaking news, installation notes, or pending ports)
  135.  
  136. ***NOTE: If there is *not* a version of TIA for your host, pleased 
  137. request one by sending an email message to tia-ports@marketplace.com. 
  138. Include the details of your platform and the type of license you would 
  139. like. We will be adding new ports for TIA based on customer demand and 
  140. will notify you via email when your requested port is ready.
  141.  
  142.  
  143. STEP 4. ENSURE TIA IS RUNNING PROPERLY
  144.  
  145. Once the .tia file is in place and the appropriate TIA binary is 
  146. copied to your account type the name of the tia file to run it.
  147.  
  148. For convenience you will want to rename the file to 'tia'. For example:
  149.  
  150. mv 386.bsdi1.1.tia  tia
  151.  
  152. To run TIA type the name of the program. For example:
  153.  
  154. ./tia     (the './' tells UNIX to look in this directory)
  155.  
  156. For the remainder of these instructions we will refer to the TIA 
  157. binary as just plain 'tia' or TIA.
  158.  
  159. When TIA is working properly it prints a copyright notice and a brief 
  160. message. For example:
  161.  
  162.      The Internet Adapter (tm) 1.0 for BSDI Unix
  163.      Copyright (c) 1994 Cyberspace Development, Inc.
  164.      Single License
  165.  
  166.      Ready to start your SLIP software.
  167.  
  168. ***NOTE: You can ingore any warning messages concerning a library 
  169. revision. For example: "ld.so: warning: /usr/lib/libc.so.1.8 has older 
  170. revision than expected"
  171.  
  172. If you see the "Ready to start your SLIP software" message above, TIA  
  173. is installed properly and you are ready to proceed to the next step. 
  174. If not, see the Troubleshooting section below.
  175.  
  176. ***NOTE: To exit TIA type five control-C's (control Key + 'C' key) in 
  177. succession, allowing at least two seconds between the first and last 
  178. one. This will cause TIA to exit normally and return you to the UNIX 
  179. prompt. (This is a nice benefit as it means users can connect 
  180. normally, use their SLIP and TCP/IP applications through TIA, but quit 
  181. TIA and then have access to their standard shell account to do things 
  182. for which they don't have a TCP/IP application.)
  183.  
  184. Here is a short troubleshooting guide to the error messages you may 
  185. receive if TIA is _not_ running properly: 
  186.  
  187. * If you get the message "Permission Denied" type the following 
  188. command:
  189.  
  190. chmod u+x tia
  191.  
  192. This will give the tia program execution permission. Try it again.
  193.  
  194. * If you are unable to set the execution permission it may be because 
  195. you have downloaded a binary that is incompatible with your host 
  196. computer (e.g., attempting to run a 386 binary on a SPARC machine).
  197.  
  198. * If you get a message saying "command not found" it means your path 
  199. probably doesn't include your home directory. You can either add your 
  200. home directory to your PATH or always run TIA by typing:
  201.  
  202. ./tia   (tells UNIX to look for program in the current directory)
  203.  
  204. * If you run TIA and get no response you probably don't have the 
  205. correct binary version for your host computer.
  206.  
  207. * If there is a problem with the evaluation time period, finding the 
  208. .tia file, the contents of the .tia file, the login name, the domain 
  209. name, etc. TIA will provide you with a short problem description. 
  210. Follow the instructions in the problem message.
  211.  
  212. ***NOTE: A TIA Single User Evaluation License is valid for 14 days 
  213. from date of issue. To check this, TIA needs to be able to confirm the 
  214. current date with an Internet time server. If the site where you are 
  215. running TIA does not have access to an Internet time server, the 
  216. Evaluation License will not work.
  217.  
  218. * If you receive an error message concerning the login name or domain 
  219. name when trying to run TIA please check to make sure the spelling of 
  220. the items listed in your .tia file matches those of your host 
  221. environment EXACTLY. Any discrepancies will result in an unusable 
  222. License Code.
  223.  
  224. If you find a misspelling and this is an Evaluation License Code, 
  225. simply reapply for a new Evaluation License Code using the correct 
  226. spelling.
  227.  
  228. If you find a misspelling and this is a Registered (i.e. paid) License 
  229. Code, please e-mail a copy of the complete text of your .tia file together 
  230. with an explanation of the misspelled items to:
  231.  
  232.      tia-support@marketplace.com.
  233.  
  234. ***NOTE: After your Single User Evaluation License expires, you can 
  235. resubmit the same order form you used for it to purchase a Registered 
  236. License. Just change the ORDER TYPE and supply the necessary credit 
  237. card information.
  238.  
  239. ----------------------------------------------------------------------
  240. It is very important not to proceed to any of the following steps 
  241. until TIA is working properly. It is much easier to debug one thing at 
  242. a time!
  243. ----------------------------------------------------------------------
  244.  
  245. STEP 5. SETUP YOUR PC OR MAC SLIP AND TCP/IP SOFTWARE TO USE TIA
  246.  
  247. SLIP and TCP/IP Software settings:
  248.  
  249. * To use your account running TIA as a SLIP account you must login to 
  250. your account either manually or under script control using a SLIP 
  251. communications software package and issue the "tia" command as the
  252. final command or script item. Then tell the SLIP software to "connect".
  253. To use your account as a standard shell account just login as you always
  254. have using any serial communications software.
  255.  
  256. SLIP communications software is available for all popular platforms as 
  257. freeware, shareware, and commercial software. Examples include: 
  258. Trumpet Winsock for PC/Windows, Intercon InterSLIP for Macintosh, 
  259. Synergy's VersaTerm SLIP for Macintosh, NetManage's Chameleon suite 
  260. for PC, Spry's AIR series, etc. For more information on SLIP and 
  261. TCP/IP tools for the "client" (PC) side be sure to check the TIA 
  262. Gopher Brochure and TIA World Wide Web Brochure on MarketPlace.com. 
  263. (gopher marketplace.com or lynx http://marketplace.com)
  264.  
  265. * With TIA you do not have, or need, your own IP address. Since most 
  266. SLIP and TCP/IP software requires you to enter one, use the dummy IP 
  267. address of 192.0.2.1 (this is reserved for test networks and never 
  268. assigned). The "NetMask" should be 255.255.255.0 (also known as a 
  269. "Class C" address).
  270.  
  271. ***NOTE: TIA itself may be able to help you with the following setup
  272. questions. (This may not work on all platforms or configurations.) Type:
  273.  
  274. tia -address
  275.  
  276. and TIA will print out information on the IP addresses and domain 
  277. names of both the Gateway and Nameservers for this host.
  278.  
  279. * The "Gateway" parameter should be set to the name and/or IP address 
  280. of the computer hosting your login account. 
  281.  
  282. * You will also need a "Nameserver" name and/or IP address. This may 
  283. be the same as the "Gateway" IP address or it may be a separate domain 
  284. name and IP address. Use tia -address, check with your Internet Access 
  285. Provider, or ask the System Administrator at your site.
  286.  
  287. * IMPORTANT: Make sure the "Compressed SLIP" or "CSLIP" flag is turned 
  288. OFF in your SLIP software.
  289.  
  290. * IMPORTANT: The parameter called "MTU Size" or "IP MTU Size" should 
  291. be set to a value equal to or greater than 1,000. We recommend using 
  292. the largest setting which should be 1,500.
  293.  
  294.  
  295. STEP 6. SETUP THE TCP/IP APPLICATION SOFTWARE
  296.  
  297. These applications will be setup the same as if you had a standard 
  298. SLIP account. They do not need to be setup any differently for TIA. 
  299. For your benefit we have included a few notes to help you get started.
  300.  
  301. WORLD WIDE WEB CLIENTS (e.g., Cello, Mosaic, etc.) - should not 
  302. require any special setup
  303.  
  304. EMAIL (e.g., Eudora) - the "SMTP Server" field should (in most cases) 
  305. be set to the domain name of the computer hosting your account. The 
  306. "POP Account" field should be the same as your full email address.
  307.  
  308. NEWS - you will need to enter a news server domain.name
  309. (e.g. news-1.provider.com)
  310.  
  311. GOPHER - should not require any special setup
  312.  
  313. FTP - should not require any special setup
  314.  
  315. TELNET - should not require any special setup
  316.  
  317. For more info on SLIP and TCP/IP Software and Applications to use with 
  318. TIA send a blank email message to tia-tcpip-info@marketplace.com.
  319.  
  320.  
  321. WHAT TIA DOES NOT SUPPORT
  322.  
  323. TIA does not enable you to provide any routing specific services back 
  324. to the Internet. For example: you cannot operate a world wide web 
  325. server on your PC and have folks connect to that server from the 
  326. Internet while connected via TIA. (To operate gopher and W3 servers 
  327. you must have a standard SLIP connection at least.)
  328.  
  329. TIA does not support "Ping" and other TCP/IP clients that require the 
  330. use of the ICMP protocol. (It does support 'finger'.)
  331.  
  332. TIA 1.0 does not support PPP today - but it will in the near future.
  333.  
  334. For more detailed information on what TIA is, and what it is not, 
  335. please request the TIA Single User FAQ as explained at the start of 
  336. this document.
  337.  
  338.  
  339. IMPORTANT NOTES
  340.  
  341. ABOUT LOGIN ACCOUNTS THAT INCLUDE A MENU: TIA must be run directly 
  342. from the UNIX prompt. If your Internet access provider offers a menu 
  343. that comes up automatically when you login, you will need to either 
  344. ask your provider to switch you to a standard shell account or
  345. add commands to your SLIP login script that take you to
  346. the menu choice for "shell" or "system prompt".
  347.  
  348. ABOUT DOMAIN NAMES: If you have a custom domain name like 
  349. person@widgets.com that is mapped to a a shell account on an Internet 
  350. access provider like person@csn.org; you will need to use the Internet 
  351. access provider's domain name when you order your TIA License Code.
  352.  
  353. ABOUT TIME-OUTS: In order to make the best use of limited resources 
  354. most Internet Access Providers include a "time out" on every shell 
  355. account. The result is that if an account is idle (no typing or data 
  356. transfer) for a certain amount of time that account is automatically 
  357. logged out. This applys to TIA as well since it is running on your 
  358. account. To reconnect after a time out just login again manually or 
  359. re-run your SLIP connect script. You do not need to restart any of the 
  360. TCP/IP applications that were up at the time of the time-out.
  361.  
  362.  
  363. WHAT ABOUT SUPPORT?
  364.  
  365. Due to the low price, high volume, and worldwide sales, Cyberspace 
  366. Development regrets that it cannot include free technical support with 
  367. TIA Single Licenses. (TIA Host and Site Licenses do, by the way.) 
  368. However we will make any and all bug fixes available for free to all 
  369. TIA customers via FTP from Marketplace.com (using 1 email broadcast to 
  370. all TIA customers about each major update).
  371.  
  372. If you purchased TIA, have read these instructions carefully, and 
  373. cannot get TIA to run on your account, please first check the Single 
  374. User FAQ file mentioned at the start of this document -- we are adding 
  375. answers to new questions daily!
  376.  
  377. If after checking the FAQ you believe you have a legitimate problem 
  378. with TIA itself (NOT with the SLIP, TCP/IP, or TCP/IP applications on 
  379. your PC or Mac, etc.) you may send a detailed description of your 
  380. problem, a complete transcript of what TIA prints out when you attempt
  381. to run it, and the complete contents of your .tia file to:
  382.  
  383.      tia-support@marketplace.com       (for Registered Licenses)
  384. or
  385.      tia-eval-support@marketplace.com  (for Evaluation Licenses)
  386.  
  387. Please note that preference will be given to technical support 
  388. questions from our Registered Customers.
  389.  
  390.  
  391. If you have any comments, feedback, or suggestions related to TIA or 
  392. Marketplace.com, please send them via email to:
  393.  
  394.      tia-feedback@marketplace.com
  395.  
  396. Thank you for trying TIA - we appreciate your business.
  397.  
  398.  
  399. (Note: the TIA Single User License agreement below is the same one you 
  400. agreed to prior to obtaining your Evaluation or Registered License. It 
  401. is provided here for your records.)
  402.  
  403.             TIA SINGLE USER SOFTWARE LICENSE AGREEMENT
  404.  
  405. PLEASE NOTE: ORDERING TIA INDICATES YOU HAVE READ THE LICENSE 
  406. AGREEMENT AND AGREED TO ITS TERMS.
  407.  
  408. 1.  The Internet Adapter ("TIA") is licensed (not sold) to you.
  409.  
  410. 2.  Cyberspace Development, Inc. grants you a nonexclusive license to 
  411. use TIA and its license code ("Code") on a single computer.  Only one 
  412. person may use this copy at a time.
  413.  
  414. 3.  You may not: (1) rent, lease or sublicense all or any portion of 
  415. the TIA or the Code; (2) modify or prepare derivative works of TIA or 
  416. the Code; (3) reverse engineer, decompile or disassemble TIA or the 
  417. Code; or (4) generate unauthorized license codes.  You agree to keep 
  418. confidential and use your best efforts to prevent and protect the 
  419. contents of TIA and the Code from unauthorized disclosure or use.
  420.  
  421.      Limited Software Product Warranty
  422.  
  423. 4. This warranty does not cover damage caused by improper use or 
  424. neglect.  We do not warrant the contents of TIA or that it will be 
  425. error free.  TIA is furnished "AS IS" and without warranty as to the 
  426. performance or results you may obtain by using TIA.  The entire risk 
  427. as to the results and performance of TIA is assumed by you.
  428.  
  429.      Disclaimer of Warranty And Limitation of Remedies
  430.  
  431. 5.  You are responsible for installation, management and operation of 
  432. TIA.
  433.  
  434. 6.  THE WARRANTIES IN THIS AGREEMENT REPLACE ALL OTHER WARRANTIES, 
  435. EXPRESS OR IMPLIED, INCLUDING ANY WARRANTIES OF MERCHANTABILITY OR 
  436. FITNESS FOR A PARTICULAR PURPOSE.  WE DISCLAIM AND EXCLUDE ALL OTHER 
  437. WARRANTIES.  IN NO EVENT WILL OUR LIABILITY OF ANY KIND INCLUDE ANY 
  438. SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES, INCLUDING LOST PROFITS, 
  439. EVEN IF WE HAVE KNOWLEDGE OF THE POTENTIAL LOSS OR DAMAGE.
  440.  
  441. 7.  Our entire liability and your exclusive remedies for our liability 
  442. of any kind (including liability for negligence except liability for 
  443. personal injury caused solely by our negligence) for TIA covered by 
  444. this Agreement and all other performance or nonperformance by us under 
  445. or related to this Agreement are limited to the remedies specified by 
  446. this Agreement.
  447.  
  448. 8.  Some states do not allow the exclusion of implied warranties, so 
  449. the above exclusion may not apply to you.  This warranty gives you 
  450. specific legal rights, and you may also have other rights which vary 
  451. from state to state.
  452.  
  453. Copyright (c) 1994 Cyberspace Development, Inc. and InterMind Corp.
  454.  
  455.